package com.sojson.service;

import java.util.List;
import java.util.Map;

import com.sojson.entity.bo.CouponUseParam;
import com.sojson.entity.po.UserCoupon;
import com.sojson.entity.vo.UserCouponVo;

/**
 * 用户优惠券Service
 * 
 * @author liu
 * @date 2021-06-02
 */
public interface UserCouponService {

    /**
     * 单条插入
     * 
     * @param userCoupon
     * @return
     */
    int insert(UserCoupon userCoupon);

    /**
     * 批量插入
     * 
     * @param userCoupon
     * @return
     */
    int insertList(UserCoupon userCoupon);

    /**
     * 通过对象批量删除(物理删除)
     * 
     * @param userCoupon
     * @return
     */
    int deleteByDto(UserCoupon userCoupon);

    /**
     * 统计全部数量
     * 
     * @return
     */
    int countAll();

    /**
     * 查询所有
     * 
     * @return
     */
    List<UserCoupon> listAll();

    /**
     * 根据对象统计数量
     * 
     * @param userCoupon
     * @return
     */
    int countByDto(UserCoupon userCoupon);

    /**
     * 根据对象查询
     * 
     * @param userCoupon
     * @return
     */
    List<UserCoupon> listByDto(UserCoupon userCoupon);

    /**
     * 通过id删除(物理删除)
     * 
     * @param id
     * @return
     */
    int deleteById(Integer id);

    /**
     * 通过id数组删除(物理删除)
     * 
     * @param ids
     * @return
     */
    int deleteByIds(Integer[] ids);

    /**
     * 通过id更新(全部更新)
     * 
     * @param userCoupon
     * @return
     */
    int updateAllById(UserCoupon userCoupon);

    /**
     * 通过id列表更新(全部更新)(更新内容相同)
     * 
     * @param userCoupon
     * @return
     */
    int updateAllByIdList(UserCoupon userCoupon);

    /**
     * 通过id列表更新(全部更新)(更新内容不相同)
     * 
     * @param userCoupon
     * @return
     */
    int updateDtoListAllById(UserCoupon userCoupon);

    /**
     * 通过id更新(局部更新)
     * 
     * @param userCoupon
     * @return
     */
    int updateById(UserCoupon userCoupon);

    /**
     * 通过id列表更新(局部更新)(更新内容相同)
     * 
     * @param userCoupon
     * @return
     */
    int updateByIdList(UserCoupon userCoupon);

    /**
     * 通过id列表更新(局部更新)(更新内容不相同)
     * 
     * @param userCoupon
     * @return
     */
    int updateDtoListById(UserCoupon userCoupon);

    /**
     * 通过id查询
     * 
     * @param id
     * @return
     */
    UserCoupon findById(Integer id);

    /**
     * 通过id数组查询
     * 
     * @param ids
     * @return
     */
    List<UserCoupon> findByIds(Integer[] ids);

    /**
     * 通过对象查询id列表
     * 
     * @param userCoupon
     * @return
     */
    List<Integer> findIdByDto(UserCoupon userCoupon);

    /**
     * 通过no删除(物理删除)
     * 
     * @param no
     * @return
     */
    int deleteByNo(String no);

    /**
     * 通过no数组删除(物理删除)
     * 
     * @param nos
     * @return
     */
    int deleteByNos(String[] nos);

    /**
     * 通过no更新(全部更新)
     * 
     * @param userCoupon
     * @return
     */
    int updateAllByNo(UserCoupon userCoupon);

    /**
     * 通过no列表更新(全部更新)(更新内容相同)
     * 
     * @param userCoupon
     * @return
     */
    int updateAllByNoList(UserCoupon userCoupon);

    /**
     * 通过no列表更新(全部更新)(更新内容不相同)
     * 
     * @param userCoupon
     * @return
     */
    int updateDtoListAllByNo(UserCoupon userCoupon);

    /**
     * 通过no更新(局部更新)
     * 
     * @param userCoupon
     * @return
     */
    int updateByNo(UserCoupon userCoupon);

    /**
     * 通过no列表更新(局部更新)(更新内容相同)
     * 
     * @param userCoupon
     * @return
     */
    int updateByNoList(UserCoupon userCoupon);

    /**
     * 通过no列表更新(局部更新)(更新内容不相同)
     * 
     * @param userCoupon
     * @return
     */
    int updateDtoListByNo(UserCoupon userCoupon);

    /**
     * 通过no查询
     * 
     * @param no
     * @return
     */
    UserCoupon findByNo(String no);

    /**
     * 通过no数组查询
     * 
     * @param nos
     * @return
     */
    List<UserCoupon> findByNos(String[] nos);

    /**
     * 通过对象查询no列表
     * 
     * @param userCoupon
     * @return
     */
    List<String> findNoByDto(UserCoupon userCoupon);

    /**
     * 清空数据(物理清空)
     */
    int clear();

    /**
     * 领取优惠券
     * 
     * @param couponId
     * @return
     * @throws Exception 
     */
    int addCoupon(Integer couponId) throws Exception;

    /**
     * 活动领取优惠券
     * 
     * @param activityId
     * @return
     * @throws Exception 
     */
    int addCouponByActivity(Integer activityId) throws Exception;

    /**
     * 获取优惠券
     * 
     * @param userCoupon
     * @return
     * @throws Exception 
     */
    List<UserCouponVo> listSimple(UserCouponVo userCoupon);

    /**
     * 根据对象查询
     * 
     * @param couponUse
     * @return
     */
    List<UserCouponVo> list(CouponUseParam couponUse);

    /**
     * 根据对象查询
     * 
     * @param couponUse
     * @return
     */
    List<UserCouponVo> listShopping(CouponUseParam couponUse);

    /**
     * 根据对象统计数量
     * 
     * @param couponUse
     * @return
     */
    int countListByDto(CouponUseParam couponUse);

    /**
     * 根据对象统计数量
     * 
     * @param couponUse
     * @return
     */
    int countListShoppingByDto(CouponUseParam couponUse);

    /**
     * 获取不可用优惠券
     * 
     * @param couponUse
     * @return
     */
    List<UserCouponVo> listNo(CouponUseParam couponUse);

    /**
     * 修改优惠券状态
     * 
     * @param userCoupon
     * @return
     */
    int updateStatus(UserCoupon userCoupon);

    /**
     * 关闭已结束的优惠券
     * 
     * @param userCoupon
     * @return
     */
    int updateStatusToEnd(UserCouponVo userCoupon);

    /**
     * 用户首页统计
     * 
     * @return
     */
    Map<String, Integer> countUser(UserCouponVo userCoupon);

}